Skip to content

Conversation

@andy-stark-redis
Copy link
Contributor

This adds a simple YAML format to generate filesystem or class hierarchy diagrams (this is another example of where AI benefits from a text format rather than a drawn diagram or ASCII art). I've added a couple of examples of where this could be used, but there are probably a few more in the docs.

All feedback is welcome (format, styling, icons in the filesystem example, etc). I'll add some docs for the YAML format too, once we're happy with it.

@github-actions
Copy link
Contributor

github-actions bot commented Nov 7, 2025

DOC-5931

Copy link
Contributor

@cmilesb cmilesb left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is pretty cool!

@cmilesb
Copy link
Contributor

cmilesb commented Nov 7, 2025

For an idea of where these could go: Adding schema info for REST API examples. It would be cool if I could have used these here instead of using a table for the POST schema.

@andy-stark-redis
Copy link
Contributor Author

OK, added some simple docs in the build folder (seems OK for now but we might want to find a better location for stuff like this). The advantage of having it in the repo rather than the wiki, say, is that the Augster can reference it directly if we add new render hooks or modify the existing ones.

@andy-stark-redis andy-stark-redis merged commit 80f43c6 into main Nov 10, 2025
8 checks passed
@andy-stark-redis andy-stark-redis deleted the DOC-5931-hier-diagram-hook branch November 10, 2025 11:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants